Inside Macintosh: QuickTime Components /

Chapter 7 - Sequence Grabber Panel Components / Sequence Grabber Panel Components Reference

Functions / Managing Your Panel Component

SGPanelCanRun

The SGPanelCanRun function allows a sequence grabber component to determine whether your panel component can work with the current sequence grabber channel component.

pascal ComponentResult SGPanelCanRun (SeqGrabPanelComponent s,
                                       SGChannel c);

s

Identifies the sequence grabber component's connection to your panel component.

c

Identifies a connection to a sequence grabber channel component. You must determine whether your panel component can operate with this channel component and its associated channel hardware.

DESCRIPTION

A sequence grabber component calls your SGPanelCanRun function in order to determine whether your component can work with a specified sequence grabber channel component and its associated hardware. If your component works only with certain hardware, you should support this function.

Set the channelFlagHasDependency component flag to 1 to cause the sequence grabber component to call this function.

The sequence grabber component provides you with a connection to the channel component in question. Your component should query the channel component to determine whether you can operate with it. You may want to use channel component functions to determine the characteristics of the digitization source attached to the channel. If your component can work with the specified channel, return a result code of noErr. Otherwise, return an appropriate sequence grabber or sequence grabber channel component result code.

If your panel component can only support a limited number of connections, you should regulate the number of active connections in your SGPanelCanRun function. Return a nonzero result code to indicate to the sequence grabber that your panel component cannot support the current connection.

RESULT CODES

noDeviceForChannel	-9408	Cannot work with specified channel
badComponentSelector	0x80008002	Function not supported

Other appropriate sequence grabber or sequence grabber channel result codes

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help